home *** CD-ROM | disk | FTP | other *** search
/ Apple Reference & Presen…tion Library 1994 January / ARPL-Jan94-Disc1of2-Partner-Edition.iso / Info Center / Business Systems Products / Oracle 7⁄AWS 95 Tech Notes / Oracle for A⁄UX Install < prev    next >
Encoding:
Text File  |  1993-11-23  |  15.6 KB  |  351 lines  |  [TEXT/EDIT]
  1. Installing ORACLE7 Server for A/UX (Version 7.0.12.2.0)                Desktop
  2. Victor Grigorieff
  3. October 13, 1993                                              Apple A/UX 3.0.1
  4.  
  5. Updated 10/28/93 by Victor Grigorieff
  6.  
  7. This bulletin describes the steps required to install ORACLE7 Server for A/UX.
  8. This document assumes that A/UX has been properly configured.  
  9. Bulletin #103947.028 describes in detail how to install A/UX 3.0.1 properly.
  10.  
  11. This bulletin only applies to the 7.0.12.2.0 Server release, as this process
  12. will most likely change with the upcoming 7.0.15 release.
  13.  
  14. Related Bulletins:
  15.  
  16. #103947.028 - Setting up an AWS 95 Server for Oracle7 for A/UX
  17.               If any part of the pre-installation checklist is not clear, or
  18.               does not work, refer to this bulletin for assistance.
  19.  
  20. #104011.574 - Tips for administrating and supporting ORACLE7 for A/UX
  21.               This bulletin describes the techniques and tricks used to setup
  22.               and debug the UNIX and Oracle installations.
  23.  
  24. Pre-Installation Checklist:
  25. --------------------------
  26.  
  27. C Compiler   You must install the C compiler for the install of Oracle to
  28.              complete.  If you type the command 'which cc' at a UNIX prompt,
  29.              you should see '/bin/cc'.  If you do not see this, you must
  30.              reinstall A/UX to install the C compiler.
  31.  
  32. Disk Space   You must have 60 megabytes of space available to install the
  33.              ORACLE7 Server for A/UX with the sample database.  You can use
  34.              the command 'df -B' to determine the amount of available space on
  35.              the currently mounted filesystems.  I recommend installing the
  36.              Oracle database files on a separate filesystem from '/', which
  37.              contains the operating system.
  38.  
  39. TCP/IP       If you intend to use SQL*Net TCP/IP, check the configuration of
  40.              the networking software.  Type the command 'hostname' to
  41.              determine the name of your host, and then try to telnet to that
  42.              host.  See Bulletin #104011.574 for more details on this.
  43.  
  44. Appletalk    If you intend to use Appletalk, check to see that the server is
  45.              connected properly to your network.  Usually, the Workgroup
  46.              Server 95 is connected to an Ethernet network.  If you are on 
  47.              an Ethernet network, check to see that the Network Control Panel
  48.              has Ethertalk selected.  Then, check the Chooser to se if you can
  49.              see other Appletalk devices on the network such as Appleshare
  50.              file servers or LaserWriter printers.
  51.  
  52.              Also, type the command:
  53.  
  54.              ls -l /usr/lib/libat.a
  55.  
  56.              If you do not see something like the following line, then you
  57.              need to reinstall A/UX, including the Network Server capability:
  58.  
  59.              -rw-r--r--   1 bin   bin     35774 Mar 23  1993 /usr/lib/libat.a
  60.              
  61.  
  62. Installation:
  63. ------------
  64.  
  65. Before installing Oracle7 Server for A/UX, log into the AWS 95 as the root
  66. user.  You must be root if you want to be able to install any SQL*Net product.
  67.  
  68. To install ORACLE7 Server for A/UX, you run the "AUX Installer" program from
  69. the folder called "Aux Installer" which is on the CD.  The Installer will ask
  70. you several questions along the way.
  71.  
  72.   Destination   You need to pick a folder to install the Oracle database and
  73.                 utilities.  This will later be known as the ORACLE_HOME, 
  74.                 which you will need to know.
  75.  
  76.      *** Important: You may not install the Oracle database in any directory
  77.      ***            whose path has a space in its name.  This means that you 
  78.      ***            may not install in the '/ Shared Data' directory.
  79.  
  80.   Oracle owner  This is the user who will own the Oracle installation.  You may
  81.                 pick an existing user, or let the Installer create a new user
  82.                 for you.  The default is to let the Installer create a new
  83.                 user named 'oracle', which is fine.
  84.  
  85.   DBA group     This is the name of the group that will have the ability to
  86.                 start and stop the database, and perform DBA-privileged 
  87.                 operations.  The Installer will create a new group for you if
  88.                 the group does not already exist.  The default is to let the 
  89.                 Installer create a new group called 'dba'.  
  90.  
  91.   Software      The ORACLE7 Server for A/UX is made up of several components.
  92.                 
  93.                    A/UX RDBMS and Utilities
  94.                    A/UX Required Support Files Version 7.0
  95.                    A/UX SQL*Net Version 1.0
  96.                  
  97.                 I recommend installing all of the options with this 7.0.12.2.0
  98.                 release.  If you know you will never need either SQL*Net
  99.                 Appletalk or TCP/IP, you may choose to leave one of them out,
  100.                 but you would not be saving a large amount of disk space.
  101.  
  102.   Procedural Option    The Installer WILL NOT ask you if you are licensed to
  103.                        use the Procedural Option.  If you are in fact 
  104.                        licensed for this option, you may enable it by running
  105.                        the script called CATPROC.SQL after installing and 
  106.                        creating the database.  This process is described in
  107.                        the Oracle7 Server Administrator's Guide.
  108.  
  109.   Distributed Option   You will be asked if you are licensed to use the
  110.                        Distributed Option.  If you are licensed, you may
  111.                        click yes. 
  112.  
  113.                        If you click yes, several features will be enabled.
  114.                        these include the ability to maintain snapshots and
  115.                        snapshot logs (remote views of databases).
  116.  
  117.                        Note:  The Distributed functionality will not work
  118.                               unless the Procedural Option is enabled.
  119.  
  120.   Seed Database   You will be asked if you would like to create the seed 
  121.                   database in the folder where you are installing oracle.
  122.  
  123.        There are good reasons to choose Yes or No, which are below:
  124.  
  125.        Yes   If you click yes, the Installer will start sqldba (the Oracle
  126.              database administration program), and run the script createdb.sql,
  127.              which was installed in the dbs directory of the oracle home.
  128.              The sample database will be named SAMP.
  129.  
  130.              This is a quick way of having a working database that you can
  131.              use for learning and testing.  The creation of this database
  132.              requires one click of the mouse.
  133.  
  134.              You will be warned that creating the database will destroy any
  135.              other datbases in this location.  If this is the first time you
  136.              have installed an Oracle database in that directory, do not worry
  137.              about this warning.
  138.  
  139.              If you already have a database named SAMP in that directory, 
  140.              choosing Yes will overwrite your old database by creating a new 
  141.              one.
  142.             
  143.  
  144.        No    You may choose not to create the seed database, because you
  145.              want to name the database something other than SAMP, or want
  146.              to use different parameters and sizes for your database. 
  147.                   
  148.              You could manually create the database, following the instructions
  149.              in chapter 2 of the "ORACLE7 Server Administrator's Guide".  This
  150.              is somewhat difficult if you have never done it before.
  151.  
  152.              Alternatively, you could make a copy of the createdb.sql script,
  153.              and edit that copy.  If I have an edited copy of createdb.sql 
  154.              called custom_createdb.sql, I could run that in sqldba to build
  155.              my database.
  156.  
  157.   Once you have answered all of the questions, the Installer will install the
  158.   options you have selected, and create a seed database if you requested that.
  159.  
  160. Post Installation Tasks:
  161. -----------------------
  162.  
  163. Once the installation is complete, you will need to go through a few more steps
  164. to properly configure the Oracle database.
  165.  
  166. SQL*Net      There are several files which need to be created/edited to 
  167.              configure SQL*Net Version 1.
  168.  
  169.      /etc/oratab    You need to create a file called oratab in the /etc
  170.                     directory. This file lists the instances (SID's) available
  171.                     on the A/UX machine.  This file is required by both the
  172.                     TCP/IP and Appletalk protocols of SQL*Net. This file has
  173.                     one line per database on the machine.  Lines beginning with
  174.                     '#' are comments which are ignored.  Each line is made up
  175.                     of the format:
  176.  
  177.                     SID:ORACLE_HOME:STARTUP
  178.  
  179.                     Where:  SID is the name of the database 
  180.                             ORACLE_HOME is where you installed the database
  181.                             STARTUP is either Y or N, which indicates whether
  182.                                     the dbstart and dbshut utilities should 
  183.                                     start or stop that database.
  184.  
  185.                     The default /etc/oratab should have the line:
  186.  
  187.                     SAMP:/users/oracle:N
  188.  
  189.   TCP/IP       If you intend to use SQL*Net TCP/IP version 1, you must edit
  190.                several files, and startup the TCP/IP listener.
  191.  
  192.          /etc/services   You need to define a port number for SQL*Net TCP/IP
  193.                          Version 1.   By default, this is 1525.  If you use
  194.                          a different number for the orasrv port number, you  
  195.                          must configure the client machines to use that same 
  196.                          number.  In most cases, you will be fine if you add
  197.                          the following line:
  198.  
  199.                          orasrv  1525/tcp  oracle  # SQL*Net Version 1
  200.  
  201.          /etc/hosts      This file lists all the IP addresses and host names
  202.                          for all machines that the A/UX server can connect to
  203.                          using TCP/IP.  If your own host is not already listed
  204.                          in the file, add an entry with the format
  205.  
  206.                          <IP address>  <hostname> <aliasname>
  207.  
  208.                          An example would be:
  209.  
  210.                          139.185.81.95 squid.us.oracle.com squid
  211.  
  212.                          You may optionally list several other aliasnames for
  213.                          each host, allowing you to call a host by several 
  214.                          different names. 
  215.  
  216.          tcpctl start    This command starts the TCP/IP listener by running
  217.                          the orasrv program.
  218.  
  219.                          This will start the orasrv process, which will listen
  220.                          for client connections on the port defined in the 
  221.                          /etc/services file.
  222.  
  223.                          Client machines would then be able to connect using
  224.                          the database connect string:
  225.   
  226.                            t:hostname:SAMP
  227.                        
  228.                          hostname is the name of the server on the TCP/IP 
  229.                          network.  SAMP is the name of the database.
  230.  
  231.   Appletalk    If you wish to use SQL*Net Appletalk version 1, you must start
  232.                the atksrv process.  As the root user, type:
  233.  
  234.                atksrv MyServer
  235.  
  236.                This will start up an Appletalk server named "MyServer".  
  237.                Client machines will connect using the database connect string:
  238.  
  239.                at:MyServer:SAMP [,Appletalk_Zone]
  240.  
  241.                You would only need to specify the Appletalk Zone if the client
  242.                machine is in a different zone than the server.
  243.               
  244.                Starting the atksrv process in this fashion will tie up that
  245.                window until you stop the listener by hitting control-C.
  246.  
  247.                You may run the atksrv process in the background by adding the 
  248.                ampersand (&) character after the command.  You could then
  249.                kill that process with the command "kill %", provided the 
  250.                atksrv process was the only background process of that window.
  251.                Please see Bulletin 104011.57 for more information on running
  252.                the atksrv process in the background.              
  253.  
  254. Oracle user    If the A/UX Installer created the oracle user, there will be no
  255.                .login file in the oracle user's home directory.  If this is
  256.                the case, log in as the oracle user, and issue the command:
  257.  
  258.                cp /usr/lib/skel/std.login ~/.login
  259.  
  260.                You will need to edit the .login file which is in the oracle
  261.                user's home directory (by default /users/oracle).  Add the 
  262.                following lines to the end of the file:
  263.  
  264.                setenv ORACLE_HOME /users/oracle
  265.                setenv ORACLE_SID  SAMP
  266.                setenv PATH        "/users/oracle/bin:/bin:/usr/bin:/usr/ucb:
  267.                                   /mac/bin:/etc:/usr/etc:/usr/local/bin"
  268.  
  269.                The examples above assume that Oracle was installed in 
  270.                /users/oracle and that the name of the SID is SAMP.  If you 
  271.                have a different oracle home or a different name of the SID,
  272.                you will need to use different values in the examples above.
  273.   
  274.       ***      Once you have edited the oracle user's .login file, you must
  275.       ***      log out, and log in again as oracle before the changes will 
  276.       ***      take effect.          
  277.                
  278.  
  279. Post-Installation Checklist:
  280. ---------------------------                         
  281.  
  282. Verify that database is running by using the ps command as shown here:
  283.  
  284.     ps -ef | grep dbwr
  285.     root   10355 10242  2 07:39:46 pb       0:00 grep dbwr
  286.     oracle  4196     1  0  Sep  2  ?        0:02 ora_dbwr_SAMP
  287.  
  288.     Look at the right-most column in this output.  If you see the process
  289.     named "ora_dbwr_SAMP", then the SAMP database is running.
  290.  
  291. Verify that the TCP/IP listener process is running by using the command
  292.  
  293.      tcpctl status
  294.      tcputl: Status summary follows
  295.      Server is running:
  296.        Started             : 21-SEP-93 10:01:29
  297.        Last connection     : 30-SEP-93 14:39:49
  298.        Total connections   : 300
  299.        Total rejections    : 6
  300.        Active subprocesses : 3
  301.        ORACLE SIDs         : S7F,SAMP
  302.        Default SID         : (null)
  303.      Logging mode is ENABLED.
  304.      DBA logins are DISABLED.
  305.      OPS$ logins are ENABLED.
  306.      OPS$ROOT logins are DISABLED.
  307.      Orasrv is detached from the terminal.
  308.      Break mode = IN BAND.
  309.      Debug level = 1
  310.      No timeout (on orasrv handshaking).
  311.      Length of listen queue = 10
  312.      Orasrv logfile = /u2/7012f/tcp/log/orasrv.log
  313. Orasrv mapfile = /etc/oratab
  314.  
  315. In the above example you see the string "Server is running", which is the 
  316. sign that TCP/IP is up and running.
  317.  
  318. Verify that the Appletalk listener is running by using the comand:
  319.  
  320.    ps -ef | grep atksrv
  321.    root 22675 22662  0 14:57:02 q2       0:00 atksrv Squid
  322.    root 22676 22662  1 14:57:28 q2       0:00 grep atksrv
  323.  
  324. Look at the right-most column in this output.  If you see the process called
  325. "atksrv Servername", then the Appletalk listener is running.
  326.  
  327. Verify that you can connect to the database using sqldba.  
  328.  
  329.    sqldba
  330.  
  331.    SQL*DBA: Release 7.0.12.2.0 - Production on Thu Sep 30 15:00:11 1993
  332.  
  333.    Copyright (c) Oracle Corporation 1979, 1993.  All rights reserved.
  334.  
  335.    ORACLE7 Server Release 7.0.12.2.0 - Production
  336.    With the procedural and distributed options
  337.    PL/SQL Release 2.0.14.0.1 - Production
  338.  
  339.    SQLDBA> connect scott/tiger
  340.    Connected.
  341.  
  342. In this output, I connected as scott/tiger, and was successful.  At this point
  343. you know that the database is running, and is accepting connections.
  344.  
  345. If you are still having problems with debugging/verifying the installation,
  346. refer to bulletin 104011.574 - Tips for administrating and supporting 
  347. ORACLE7 for A/UX.
  348.  
  349.  
  350.  
  351.